IRIX 6.5 Complementary Applications 2004 February

home *** CD-ROM | disk | FTP | other *** search

/ IRIX 6.5 Complementary Applications 2004 February / SGI IRIX 6.5 Complementary Applications 2004 February.iso / dist / cde.idb / usr / dt / share / man / cat3 / XmRowColumn.z.z / XmRowColumn.z / XmRowColumn

Wrap

Text File | 2003-11-18 | 73.7 KB | 1,519 lines

XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) NNNNAAAAMMMMEEEE _X_m_R_o_w_C_o_l_u_m_n - The RowColumn widget class SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS #include <Xm/RowColumn.h> DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN The RowColumn widget is a general purpose RowColumn manager capable of containing any widget type as a child. In general, it requires no special knowledge about how its children function and provides nothing beyond support for several different layout styles. However, it can be configured as a menu, in which case, it expects only certain children, and it configures to a particular layout. The menus supported are: MenuBar, Pulldown or Popup MenuPanes, and OptionMenu. The type of layout performed is controlled by how the application has set the various layout resources. It can be configured to lay out its children in either rows or columns. In addition, the application can specify how the children are laid out, as follows: +o the children are packed tightly together into either rows or columns +o each child is placed in an identically sized box (producing a symmetrical look) +o a specific layout (the current xxxx and yyyy positions of the children control their location) In addition, the application has control over both the spacing that occurs between each row and column and the margin spacing present between the edges of the RowColumn widget and any children that are placed against it. In a MenuBar, Pulldown MenuPane, or Popup MenuPane the default for the _X_m_N_s_h_a_d_o_w_T_h_i_c_k_n_e_s_s resource is 2. In an OptionMenu or a WorkArea (such as a RadioBox or CheckBox) this resource is not applicable and its use is undefined. If an application wishes to place a 3-D shadow around an OptionMenu or WorkArea, it can create the RowColumn as a child of a Frame widget. In a MenuBar, Pulldown MenuPane, or Popup MenuPane the _X_m_N_n_a_v_i_g_a_t_i_o_n_T_y_p_e resource is not applicable and its use is undefined. In a WorkArea the default for _X_m_N_n_a_v_i_g_a_t_i_o_n_T_y_p_e is _X_m_T_A_B__G_R_O_U_P. In an OptionMenu the default for _X_m_N_n_a_v_i_g_a_t_i_o_n_T_y_p_e is _X_m_N_O_N_E. In a MenuBar, Pulldown MenuPane, or Popup MenuPane the Page 1 (printed 11/11/03) XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) _X_m_N_t_r_a_v_e_r_s_a_l_O_n resource is not applicable and its use is undefined. In an OptionMenu or WorkArea the default for _X_m_N_t_r_a_v_e_r_s_a_l_O_n is True. If the parent of the RowColumn is a MenuShell, the _X_m_N_m_a_p_p_e_d_W_h_e_n_M_a_n_a_g_e_d resource is forced to False when the widget is realized. The user can specify resources in a resource file for the automatically created widgets and gadgets of an OptionMenu. The following list identifies the names of these widgets (or gadgets) and the associated OptionMenu areas. +o Option Menu Label Gadget - "OptionLabel" +o Option Menu Cascade Button - "OptionButton" TTTTeeeeaaaarrrr----ooooffffffff MMMMeeeennnnuuuussss Pulldown and Popup MenuPanes support tear-off menus, which enable the user to retain a MenuPane on the display to facilitate subsequent menu selections. A MenuPane that can be torn-off is identified by a tear-off button that spans the width of the MenuPane and displays a dashed line. A torn-off MenuPane contains a window manager system menu icon and a title bar. The window title displays the label of the cascade button that initiated the action when the label type is _X_m_S_T_R_I_N_G. If the label contains a pixmap the window title is empty. A tear-off menu from a Popup MenuPane also displays an empty title. The user can tear-off a MenuPane using the mouse or keyboard. Clicking _B_S_e_l_e_c_t or pressing _K_A_c_t_i_v_a_t_e (or _K_S_e_l_e_c_t) on the tear-off button, tears off the MenuPane at the current position. Pressing _B_D_r_a_g on the tear-off button tears off the MenuPane, and allows the user to drag the torn-off menu to a new position designated by releasing the mouse button. Tearing off a MenuPane unposts the current active menu. Only one tear-off copy for each MenuPane is allowed. Subsequent tear-off actions of a torn MenuPane unpost the existing copy first. The name of the tear-off button of a torn-off menu pane is "TearOffControl". The name can be used to set resources in a resource file. An application can also obtain the tear- off button itself using _X_m_G_e_t_T_e_a_r_O_f_f_C_o_n_t_r_o_l and then set resource values by calling _X_t_S_e_t_V_a_l_u_e_s. The tear-off button has Separator-like behavior. Its appearance can be specified using the following tear-off button resources: _X_m_N_b_a_c_k_g_r_o_u_n_d, _X_m_N_b_a_c_k_g_r_o_u_n_d_P_i_x_m_a_p,_X_m_N_b_o_t_t_o_m_S_h_a_d_o_w_C_o_l_o_r, _X_m_N_f_o_r_e_g_r_o_u_n_d, _X_m_N_h_e_i_g_h_t, _X_m_N_m_a_r_g_i_n, _X_m_N_s_e_p_a_r_a_t_o_r_T_y_p_e, _X_m_N_s_h_a_d_o_w_T_h_i_c_k_n_e_s_s, Page 2 (printed 11/11/03) XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) and _X_m_N_t_o_p_S_h_a_d_o_w_C_o_l_o_r. Refer to the _X_m_S_e_p_a_r_a_t_o_r man page for a complete description of each of these resources. RowColumn resources that affect tear-off menu behavior are _X_m_N_t_e_a_r_O_f_f_M_o_d_e_l, _X_m_N_t_e_a_r_O_f_f_M_e_n_u_A_c_t_i_v_a_t_e_C_a_l_l_b_a_c_k, and _X_m_N_t_e_a_r_O_f_f_M_e_n_u_D_e_a_c_t_i_v_a_t_e_C_a_l_l_b_a_c_k. By default, menus do not tear off; tear off functionality may be enabled by setting the _X_m_N_t_e_a_r_O_f_f_M_o_d_e_l resource to _X_m_T_E_A_R__O_F_F__E_N_A_B_L_E_D. There is no resource converter pre- registered for _X_m_N_t_e_a_r_O_f_f_M_o_d_e_l. To allow tear-off functionality to be enabled through the resource database call the function _X_m_R_e_p_T_y_p_e_I_n_s_t_a_l_l_T_e_a_r_O_f_f_M_o_d_e_l_C_o_n_v_e_r_t_e_r. Tear-off menu focus policy follows standard window manager policy. It is recommended that the following _m_w_m resources are set to True: _s_t_a_r_t_u_p_K_e_y_F_o_c_u_s and _a_u_t_o_K_e_y_F_o_c_u_s. CCCCllllaaaasssssssseeeessss RowColumn inherits behavior and resources from _C_o_r_e, _C_o_m_p_o_s_i_t_e, _C_o_n_s_t_r_a_i_n_t, and _X_m_M_a_n_a_g_e_r classes. The class pointer is _x_m_R_o_w_C_o_l_u_m_n_W_i_d_g_e_t_C_l_a_s_s. The class name is _X_m_R_o_w_C_o_l_u_m_n. NNNNeeeewwww RRRReeeessssoooouuuurrrrcccceeeessss The following table defines a set of widget resources used by the programmer to specify data. The programmer can also set the resource values for the inherited classes to set attributes for this widget. To reference a resource by name or by class in a .Xdefaults file, remove the _X_m_N or _X_m_C prefix and use the remaining letters. To specify one of the defined values for a resource in a .Xdefaults file, remove the _X_m prefix and use the remaining letters (in either lowercase or uppercase, but include any underscores between words). The codes in the access column indicate if the given resource can be set at creation time (C), set by using _X_t_S_e_t_V_a_l_u_e_s (S), retrieved by using _X_t_G_e_t_V_a_l_u_e_s (G), or is not applicable (N/A). XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt NNNNaaaammmmeeee CCCCllllaaaassssssss TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss __________________________________________________________________________________________________________ XmNadjustLast XmCAdjustLast Boolean True CSG XmNadjustMargin XmCAdjustMargin Boolean True CSG XmNentryAlignment XmCAlignment unsigned char XmALIGNMENT_BEGINNING CSG XmNentryBorder XmCEntryBorder Dimension 0 CSG XmNentryCallback XmCCallback XtCallbackList NULL C XmNentryClass XmCEntryClass WidgetClass dynamic CSG Page 3 (printed 11/11/03) XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) XmNentryVerticalAlignment XmCVerticalAlignment unsigned char XmALIGNMENT_CENTER CSG XmNisAligned XmCIsAligned Boolean True CSG XmNisHomogeneous XmCIsHomogeneous Boolean dynamic CG XmNlabelString XmCXmString XmString NULL C XmNmapCallback XmCCallback XtCallbackList NULL C XmNmarginHeight XmCMarginHeight Dimension dynamic CSG XmNmarginWidth XmCMarginWidth Dimension dynamic CSG XmNmenuAccelerator XmCAccelerators String dynamic CSG XmNmenuHelpWidget XmCMenuWidget Widget NULL CSG XmNmenuHistory XmCMenuWidget Widget NULL CSG XmNmenuPost XmCMenuPost String NULL CSG XmNmnemonic XmCMnemonic KeySym NULL CSG XmNmnemonicCharSet XmCMnemonicCharSet String XmFONTLIST_DEFAULT_TAG CSG XmNnumColumns XmCNumColumns short 1 CSG XmNorientation XmCOrientation unsigned char dynamic CSG XmNpacking XmCPacking unsigned char dynamic CSG XmNpopupEnabled XmCPopupEnabled Boolean True CSG XmNradioAlwaysOne XmCRadioAlwaysOne Boolean True CSG XmNradioBehavior XmCRadioBehavior Boolean False CSG XmNresizeHeight XmCResizeHeight Boolean True CSG XmNresizeWidth XmCResizeWidth Boolean True CSG XmNrowColumnType XmCRowColumnType unsigned char XmWORK_AREA CG XmNspacing XmCSpacing Dimension dynamic CSG XmNsubMenuId XmCMenuWidget Widget NULL CSG XmNtearOffMenuActivateCallback XmCCallback XtCallbackList NULL C XmNtearOffMenuDeactivateCallback XmCCallback XtCallbackList NULL C XmNtearOffModel XmCTearOffModel unsigned char XmTEAR_OFF_DISABLED CSG XmNunmapCallback XmCCallback XtCallbackList NULL C XmNwhichButton XmCWhichButton unsigned int dynamic CSG _X_m_N_a_d_j_u_s_t_L_a_s_t Extends the last row of children to the bottom edge of RowColumn (when _X_m_N_o_r_i_e_n_t_a_t_i_o_n is _X_m_H_O_R_I_Z_O_N_T_A_L) or extends the last column to the right edge of RowColumn (when _X_m_N_o_r_i_e_n_t_a_t_i_o_n is _X_m_V_E_R_T_I_C_A_L). This feature is disabled by setting _X_m_N_a_d_j_u_s_t_L_a_s_t to False. _X_m_N_a_d_j_u_s_t_M_a_r_g_i_n Specifies whether the inner minor margins of all items contained within the RowColumn widget are forced to the same value. The inner minor margin corresponds to the _X_m_N_m_a_r_g_i_n_L_e_f_t, _X_m_N_m_a_r_g_i_n_R_i_g_h_t, _X_m_N_m_a_r_g_i_n_T_o_p, and _X_m_N_m_a_r_g_i_n_B_o_t_t_o_m resources supported by _X_m_L_a_b_e_l and _X_m_L_a_b_e_l_G_a_d_g_e_t. A horizontal orientation causes _X_m_N_m_a_r_g_i_n_T_o_p and _X_m_N_m_a_r_g_i_n_B_o_t_t_o_m for all items in a particular row to be forced to the same value; the value is the largest margin specified for one of the Label items. A vertical orientation causes _X_m_N_m_a_r_g_i_n_L_e_f_t and Page 4 (printed 11/11/03) XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) _X_m_N_m_a_r_g_i_n_R_i_g_h_t for all items in a particular column to be forced to the same value; the value is the largest margin specified for one of the Label items. This keeps all text within each row or column lined up with all other text in its row or column. If the _X_m_N_r_o_w_C_o_l_u_m_n_T_y_p_e is either _X_m_M_E_N_U__P_O_P_U_P or _X_m_M_E_N_U__P_U_L_L_D_O_W_N and this resource is True, only button children have their margins adjusted. _X_m_N_e_n_t_r_y_A_l_i_g_n_m_e_n_t Specifies the alignment type for children that are subclasses of _X_m_L_a_b_e_l or _X_m_L_a_b_e_l_G_a_d_g_e_t when _X_m_N_i_s_A_l_i_g_n_e_d is enabled. The following are textual alignment types: _X_m_A_L_I_G_N_M_E_N_T__B_E_G_I_N_N_I_N_G - the default _X_m_A_L_I_G_N_M_E_N_T__C_E_N_T_E_R _X_m_A_L_I_G_N_M_E_N_T__E_N_D See the description of _X_m_N_a_l_i_g_n_m_e_n_t in the _X_m_L_a_b_e_l(_3_X) man page for an explanation of these actions. _X_m_N_e_n_t_r_y_B_o_r_d_e_r Imposes a uniform border width upon all RowColumn's children. The default value is 0, which disables the feature. _X_m_N_e_n_t_r_y_C_a_l_l_b_a_c_k Disables the _X_m_N_a_c_t_i_v_a_t_e_C_a_l_l_b_a_c_k and _X_m_N_v_a_l_u_e_C_h_a_n_g_e_d_C_a_l_l_b_a_c_k callbacks for all CascadeButton, DrawnButton, PushButton, and ToggleButton widgets and gadgets contained within the RowColumn widget. If the application supplies this resource, the _X_m_N_a_c_t_i_v_a_t_e_C_a_l_l_b_a_c_k and _X_m_N_v_a_l_u_e_C_h_a_n_g_e_d_C_a_l_l_b_a_c_k callbacks are then revectored to the _X_m_N_e_n_t_r_y_C_a_l_l_b_a_c_k callbacks. This allows an application to supply a single callback routine for handling all items contained in a RowColumn widget. The callback reason is _X_m_C_R__A_C_T_I_V_A_T_E. If the application does not supply this resource, the _X_m_N_a_c_t_i_v_a_t_e_C_a_l_l_b_a_c_k and _X_m_N_v_a_l_u_e_C_h_a_n_g_e_d_C_a_l_l_b_a_c_k callbacks for each item in the RowColumn widget work as normal. The application must supply this resource when this widget is created. Changing this resource using the Page 5 (printed 11/11/03) XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) _X_t_S_e_t_V_a_l_u_e_s is not supported. _X_m_N_e_n_t_r_y_C_l_a_s_s Specifies the only widget class that can be added to the RowColumn widget; this resource is meaningful only when the _X_m_N_i_s_H_o_m_o_g_e_n_e_o_u_s resource is set to True. Both widget and gadget variants of the specified class may be added to the widget. When _X_m_C_r_e_a_t_e_R_a_d_i_o_B_o_x is called or when _X_m_N_r_o_w_C_o_l_u_m_n_T_y_p_e is set to _X_m_W_O_R_K__A_R_E_A and _X_m_N_r_a_d_i_o_B_e_h_a_v_i_o_r is True, the default value of _X_m_N_e_n_t_r_y_C_l_a_s_s is _x_m_T_o_g_g_l_e_B_u_t_t_o_n_G_a_d_g_e_t_C_l_a_s_s. When _X_m_N_r_o_w_C_o_l_u_m_n_T_y_p_e is set to _X_m_M_E_N_U__B_A_R, the value of _X_m_N_e_n_t_r_y_C_l_a_s_s is forced to _x_m_C_a_s_c_a_d_e_B_u_t_t_o_n_W_i_d_g_e_t_C_l_a_s_s. _X_m_N_e_n_t_r_y_V_e_r_t_i_c_a_l_A_l_i_g_n_m_e_n_t Specifies the type of vertical alignment for children that are subclasses of _X_m_L_a_b_e_l, _X_m_L_a_b_e_l_G_a_d_g_e_t, _a_n_d _X_m_T_e_x_t. _T_h_i_s _r_e_s_o_u_r_c_e _i_s _i_n_v_a_l_i_d _i_f _X_m_N_o_r_i_e_n_t_a_t_i_o_n _i_s _X_m_V_E_R_T_I_C_A_L _a_n_d _X_m_N_p_a_c_k_i_n_g _i_s _X_m_P_A_C_K__T_I_G_H_T _b_e_c_a_u_s_e _t_h_i_s _l_a_y_o_u_t _p_r_e_s_e_r_v_e_s _v_a_r_i_a_b_l_e _h_e_i_g_h_t_s _a_m_o_n_g _t_h_e _c_h_i_l_d_r_e_n. _T_h_e _v_e_r_t_i_c_a_l _a_l_i_g_n_m_e_n_t _t_y_p_e_s _i_n_c_l_u_d_e: +o _X_m_A_L_I_G_N_M_E_N_T__B_A_S_E_L_I_N_E__B_O_T_T_O_M - causes the bottom baseline of all children in a row to be aligned. This resource is applicable only when all children in a row contain textual data. +o _X_m_A_L_I_G_N_M_E_N_T__B_A_S_E_L_I_N_E__T_O_P - causes the top baseline of all children in a row to be aligned. This resource is applicable only when all children in a row contain textual data. +o _X_m_A_L_I_G_N_M_E_N_T__C_O_N_T_E_N_T_S__B_O_T_T_O_M - causes the bottom of the contents (text or pixmap) of all children in a row to be aligned. +o _X_m_A_L_I_G_N_M_E_N_T__C_E_N_T_E_R - causes the center of all children in a row to be aligned. +o _X_m_A_L_I_G_N_M_E_N_T__C_O_N_T_E_N_T_S__T_O_P - causes the top of the contents (text or pixmap) of all children in a row to be aligned. _X_m_N_i_s_A_l_i_g_n_e_d Specifies text alignment for each item within the RowColumn widget; this applies only to items that are subclasses of _X_m_L_a_b_e_l or _X_m_L_a_b_e_l_G_a_d_g_e_t. However, if the item is a Label widget or gadget and its parent is either a Popup MenuPane or a Pulldown MenuPane, alignment is not performed; the Label is treated as the Page 6 (printed 11/11/03) XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) title within the MenuPane, and the alignment set by the application is not overridden. _X_m_N_e_n_t_r_y_A_l_i_g_n_m_e_n_t controls the type of textual alignment. _X_m_N_i_s_H_o_m_o_g_e_n_e_o_u_s Indicates whether the RowColumn widget should enforce exact homogeneity among the items it contains; if True, only the widgets that are of the class indicated by _X_m_N_e_n_t_r_y_C_l_a_s_s are allowed as children of the RowColumn widget. This is most often used when creating a MenuBar. Attempting to insert a child that is not a member of the specified class generates a warning message. In a MenuBar the value of _X_m_N_i_s_H_o_m_o_g_e_n_e_o_u_s is forced to True. In an OptionMenu the value is forced to False. When _X_m_C_r_e_a_t_e_R_a_d_i_o_B_o_x is called the default value is True. Otherwise, the default value is False. _X_m_N_l_a_b_e_l_S_t_r_i_n_g Points to a text string, which displays the label to one side of the selection area when _X_m_N_r_o_w_C_o_l_u_m_n_T_y_p_e is set to _X_m_M_E_N_U__O_P_T_I_O_N. This resource is not meaningful for all other RowColumn types. If the application wishes to change the label after creation, it must get the LabelGadget ID (_X_m_O_p_t_i_o_n_L_a_b_e_l_G_a_d_g_e_t) and call _X_t_S_e_t_V_a_l_u_e_s on the LabelGadget directly. The default value is no label. _X_m_N_m_a_p_C_a_l_l_b_a_c_k Specifies a widget-specific callback function that is invoked when the window associated with the RowColumn widget is about to be mapped. The callback reason is _X_m_C_R__M_A_P. _X_m_N_m_a_r_g_i_n_H_e_i_g_h_t Specifies the amount of blank space between the top edge of the RowColumn widget and the first item in each column, and the bottom edge of the RowColumn widget and the last item in each column. The default value is 0 for Pulldown and Popup MenuPanes, and 3 pixels for other RowColumn types. _X_m_N_m_a_r_g_i_n_W_i_d_t_h Specifies the amount of blank space between the left edge of the RowColumn widget and the first item in each row, and the right edge of the RowColumn widget and the last item in each row. The default value is 0 for Pulldown and Popup MenuPanes, and 3 pixels for other RowColumn types. _X_m_N_m_e_n_u_A_c_c_e_l_e_r_a_t_o_r Page 7 (printed 11/11/03) XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) This resource is useful only when the RowColumn widget has been configured to operate as a Popup MenuPane or a MenuBar. The format of this resource is similar to the left side specification of a translation string, with the limitation that it must specify a key event. For a Popup MenuPane, when the accelerator is typed by the user, the Popup MenuPane is posted. For a MenuBar, when the accelerator is typed by the user, the first item in the MenuBar is highlighted, and traversal is enabled in the MenuBar. The default for a Popup MenuPane is _K_M_e_n_u. The default for a MenuBar is _K_M_e_n_u_B_a_r. The accelerator can be disabled by setting the _X_m_N_p_o_p_u_p_E_n_a_b_l_e_d resource to False. _X_m_N_m_e_n_u_H_e_l_p_W_i_d_g_e_t Specifies the widget ID for the CascadeButton, which is treated as the Help widget if _X_m_N_r_o_w_C_o_l_u_m_n_T_y_p_e is set to _X_m_M_E_N_U__B_A_R. The MenuBar always places the Help widget at the bottom right corner (in a lef to right environment) of the MenuBar. If the RowColumn widget is any type other than _X_m_M_E_N_U__B_A_R, this resource is not meaningful. _X_m_N_m_e_n_u_H_i_s_t_o_r_y Specifies the widget ID of the last menu entry to be activated. It is also useful for specifying the current selection for an OptionMenu. If _X_m_N_r_o_w_C_o_l_u_m_n_T_y_p_e is set to _X_m_M_E_N_U__O_P_T_I_O_N, the specified menu item is positioned under the cursor when the menu is displayed. If the RowColumn widget has the _X_m_N_r_a_d_i_o_B_e_h_a_v_i_o_r resource set to True, the widget field associated with this resource contains the widget ID of the last ToggleButton or ToggleButtonGadget to change from unselected to selected. The default value is the widget ID of the first child in the widget. _X_m_N_m_e_n_u_P_o_s_t Specifies an X event description indicating a button event that posts a menu system. The default for _X_m_M_E_N_U__P_O_P_U_P is _B_M_e_n_u _P_r_e_s_s. The default for _X_m_M_E_N_U__O_P_T_I_O_N, _X_m_M_E_N_U__B_A_R, and _X_m_W_O_R_K__A_R_E_A is _B_S_e_l_e_c_t _P_r_e_s_s. The _X_m_N_m_e_n_u_P_o_s_t resource for pulldowns should be consistent with that of top-level parent menu (although the event type is ignored). Setting this resource to _B_D_r_a_g _P_r_e_s_s will conflict with drag and drop operations, which use _B_D_r_a_g _P_r_e_s_s as a default button binding. _X_m_N_m_n_e_m_o_n_i_c This resource is useful only when _X_m_N_r_o_w_C_o_l_u_m_n_T_y_p_e is Page 8 (printed 11/11/03) XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) set to _X_m_M_E_N_U__O_P_T_I_O_N. Specifies a keysym for a key that, when pressed by the user along with the _M_A_l_t modifier, posts the associated Pulldown MenuPane. The first character in the OptionMenu label string that exactly matches the mnemonic in the character set specified in _X_m_N_m_n_e_m_o_n_i_c_C_h_a_r_S_e_t is underlined. The user can post the menu by pressing either the shifted or the unshifted mnemonic key. The default is no mnemonic. _X_m_N_m_n_e_m_o_n_i_c_C_h_a_r_S_e_t Specifies the character set of the mnemonic for an OptionMenu. The default is _X_m_F_O_N_T_L_I_S_T__D_E_F_A_U_L_T__T_A_G. If the RowColumn widget is any type other than _X_m_M_E_N_U__O_P_T_I_O_N, this resource is not meaningful. _X_m_N_n_u_m_C_o_l_u_m_n_s Specifies the number of minor dimension extensions that are made to accommodate the entries; this attribute is meaningful only when _X_m_N_p_a_c_k_i_n_g is set to _X_m_P_A_C_K__C_O_L_U_M_N. For vertically oriented RowColumn widgets, this attribute indicates how many columns are built; the number of entries per column is adjusted to maintain this number of columns, if possible. For horizontally oriented RowColumn widgets, this attribute indicates how many rows are built. The default value is 1. In an OptionMenu the value is forced to 1. The value must be greater than 0. _X_m_N_o_r_i_e_n_t_a_t_i_o_n Determines whether RowColumn layouts are row-major or column-major. In a column-major layout, the children of the RowColumn are laid out in columns top to bottom within the widget. In a row-major layout the children of the RowColumn are laid out in rows. _X_m_V_E_R_T_I_C_A_L resource value selects a column-major layout. _X_m_H_O_R_I_Z_O_N_T_A_L resource value selects a row-major layout. When creating a MenuBar or an OptionMenu, the default is _X_m_H_O_R_I_Z_O_N_T_A_L. Otherwise, the default value is _X_m_V_E_R_T_I_C_A_L. The results of specifying a value of _X_m_V_E_R_T_I_C_A_L for a MenuBar are undefined. _X_m_N_p_a_c_k_i_n_g Specifies how to pack the items contained within a RowColumn widget. This can be set to _X_m_P_A_C_K__T_I_G_H_T, _X_m_P_A_C_K__C_O_L_U_M_N or _X_m_P_A_C_K__N_O_N_E. When a RowColumn widget packs the items it contains, it determines its major Page 9 (printed 11/11/03) XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) dimension using the value of the _X_m_N_o_r_i_e_n_t_a_t_i_o_n resource. _X_m_P_A_C_K__T_I_G_H_T indicates that given the current major dimension (for example, vertical if _X_m_N_o_r_i_e_n_t_a_t_i_o_n is _X_m_V_E_R_T_I_C_A_L), entries are placed one after the other until the RowColumn widget must wrap. RowColumn wraps when there is no room left for a complete child in that dimension. Wrapping occurs by beginning a new row or column in the next available space. Wrapping continues, as often as necessary, until all of the children are laid out. In the vertical dimension (columns), boxes are set to the same width; in the horizontal dimension (rows), boxes are set to the same depth. Each entry's position in the major dimension is left unaltered (for example, _X_m_N_y is left unchanged when _X_m_N_o_r_i_e_n_t_a_t_i_o_n is _X_m_V_E_R_T_I_C_A_L); its position in the minor dimension is set to the same value as the greatest entry in that particular row or column. The position in the minor dimension of any particular row or column is independent of all other rows or columns. _X_m_P_A_C_K__C_O_L_U_M_N indicates that all entries are placed in identically sized boxes. The box is based on the largest height and width values of all the children widgets. The value of the _X_m_N_n_u_m_C_o_l_u_m_n_s resource determines how many boxes are placed in the major dimension, before extending in the minor dimension. _X_m_P_A_C_K__N_O_N_E indicates that no packing is performed. The x and y attributes of each entry are left alone, and the RowColumn widget attempts to become large enough to enclose all entries. When _X_m_C_r_e_a_t_e_R_a_d_i_o_B_o_x is called or when _X_m_N_r_o_w_C_o_l_u_m_n_T_y_p_e is set to _X_m_W_O_R_K__A_R_E_A and _X_m_N_r_a_d_i_o_B_e_h_a_v_i_o_r is True, the default value of _X_m_N_p_a_c_k_i_n_g is _X_m_P_A_C_K__C_O_L_U_M_N. In an OptionMenu the value is initialized to _X_m_P_A_C_K__T_I_G_H_T. Otherwise, the value defaults to _X_m_P_A_C_K__T_I_G_H_T. _X_m_N_p_o_p_u_p_E_n_a_b_l_e_d Allows the menu system to enable keyboard input (accelerators and mnemonics) defined for the Popup MenuPane and any of its submenus. The Popup MenuPane needs to be informed whenever its accessibility to the user changes because posting of the Popup MenuPane is controlled by the application. The default value of this resource is True (keyboard input - accelerators and mnemonics - defined for the Popup MenuPane and any of its submenus is enabled). Page 10 (printed 11/11/03) XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) _X_m_N_r_a_d_i_o_A_l_w_a_y_s_O_n_e If True, forces the active ToggleButton or ToggleButtonGadget to be automatically selected after having been unselected (if no other toggle was activated). If False, the active toggle may be unselected. The default value is True. This resource is important only when _X_m_N_r_a_d_i_o_B_e_h_a_v_i_o_r is True. The application can always add and subtract toggles from RowColumn regardless of the selected/unselected state of the toggle. The application can also manage and unmanage toggle children of RowColumn at any time regardless of state. Therefore, the application can sometimes create a RowColumn that has _X_m_N_r_a_d_i_o_A_l_w_a_y_s_O_n_e set to True and none of the toggle children selected. The result is undefined if the value of this resource is True and the application sets more than one ToggleButton at a time. _X_m_N_r_a_d_i_o_B_e_h_a_v_i_o_r Specifies a Boolean value that when True, indicates that the RowColumn widget should enforce a RadioBox- type behavior on all of its children that are ToggleButtons or ToggleButtonGadgets. When the value of this resource is True, _X_m_N_i_n_d_i_c_a_t_o_r_T_y_p_e defaults to _X_m_O_N_E__O_F__M_A_N_Y for ToggleButton and ToggleButtonGadget children. RadioBox behavior dictates that when one toggle is selected and the user selects another toggle, the first toggle is unselected automatically. The RowColumn usually does not enforce this behavior if the application, rather than the user, changes the state of a toggle. The RowColumn does enforce this behavior if a toggle child is selected using _X_m_T_o_g_g_l_e_B_u_t_t_o_n_S_e_t_S_t_a_t_e or _X_m_T_o_g_g_l_e_B_u_t_t_o_n_G_a_d_g_e_t_S_e_t_S_t_a_t_e with a nnnnoooottttiiiiffffyyyy argument of True. When _X_m_C_r_e_a_t_e_R_a_d_i_o_B_o_x is called the default value of _X_m_N_r_a_d_i_o_B_e_h_a_v_i_o_r is True. Otherwise, the default value is False. _X_m_N_r_e_s_i_z_e_H_e_i_g_h_t Requests a new height if necessary, when set to True. When set to False, the widget does not request a new height regardless of any changes to the widget or its Page 11 (printed 11/11/03) XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) children. _X_m_N_r_e_s_i_z_e_W_i_d_t_h Requests a new width if necessary, when set to True. When set to False, the widget does not request a new width regardless of any changes to the widget or its children. _X_m_N_r_o_w_C_o_l_u_m_n_T_y_p_e Specifies the type of RowColumn widget to be created. It is a non-standard resource that cannot be changed after it is set. If an application uses any of the convenience routines, except _X_m_C_r_e_a_t_e_R_o_w_C_o_l_u_m_n, this resource is automatically forced to the appropriate value by the convenience routine. If an application uses the Xt Intrinsics API to create its RowColumn widgets, it must specify this resource itself. The set of possible settings for this resource are: _X_m_W_O_R_K__A_R_E_A - the default _X_m_M_E_N_U__B_A_R _X_m_M_E_N_U__P_U_L_L_D_O_W_N _X_m_M_E_N_U__P_O_P_U_P _X_m_M_E_N_U__O_P_T_I_O_N This resource cannot be changed after the RowColumn widget is created. Any changes attempted through _X_t_S_e_t_V_a_l_u_e_s are ignored. The value of this resource is used to determine the value of a number of other resources. The descriptions of RowColumn resources explain this when it is the case. The resource _X_m_N_n_a_v_i_g_a_t_i_o_n_T_y_p_e, inherited from _X_m_M_a_n_a_g_e_r, is changed to _X_m_N_O_N_E if _X_m_N_r_o_w_C_o_l_u_m_n_T_y_p_e is _X_m_M_E_N_U__O_P_T_I_O_N. _X_m_N_s_p_a_c_i_n_g Specifies the horizontal and vertical spacing between items contained within the RowColumn widget. The default value is 3 pixels for _X_m_O_P_T_I_O_N__M_E_N_U and _X_m_W_O_R_K__A_R_E_A and 0 for other RowColumn types. _X_m_N_s_u_b_M_e_n_u_I_d Specifies the widget ID for the Pulldown MenuPane to be associated with an OptionMenu. This resource is useful only when _X_m_N_r_o_w_C_o_l_u_m_n_T_y_p_e is set to _X_m_M_E_N_U__O_P_T_I_O_N. The default value is NULL. Page 12 (printed 11/11/03) XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) _X_m_N_t_e_a_r_O_f_f_M_e_n_u_A_c_t_i_v_a_t_e_C_a_l_l_b_a_c_k Specifies the callback list that notifies the application when the tear-off MenuPane is about to be activated. It precedes the tear-off's map callback. Use this resource when your application has shared MenuPanes and when the torn-off menu can have two or more parents that can have opposing sensitivity states for the same menu item. This resource enables the application to track whether a menu item is sensitive or insensitive and to set the state to the original parent's menu item state when the torn-off menu is reposted. The application can use _X_m_G_e_t_P_o_s_t_e_d_F_r_o_m_W_i_d_g_e_t to determine from which parent the menu was torn. The callback reason is _X_m_C_R__T_E_A_R__O_F_F__A_C_T_I_V_A_T_E. The default is NULL. _X_m_N_t_e_a_r_O_f_f_M_e_n_u_D_e_a_c_t_i_v_a_t_e_C_a_l_l_b_a_c_k Specifies the callback list that notifies the application when the tear-off MenuPane is about to be deactivated. It follows the tear-off's unmap callback. Use this resource when your application has shared MenuPanes and when the torn-off menu can have two or more parents that can have opposing sensitivity states for the same menu item. This resource enables the application to track whether a menu item is sensitive or insensitive and to set the state to the original parent's menu item state when the torn-off menu is reposted. The application can use _X_m_G_e_t_P_o_s_t_e_d_F_r_o_m_W_i_d_g_e_t to determine from which parent the menu was torn. The callback reason is _X_m_C_R__T_E_A_R__O_F_F__D_E_A_C_T_I_V_A_T_E. The default is NULL. _X_m_N_t_e_a_r_O_f_f_M_o_d_e_l Indicates whether tear-off functionality is enabled or disabled when _X_m_N_r_o_w_C_o_l_u_m_n_T_y_p_e is set to _X_m_M_E_N_U__P_U_L_L_D_O_W_N or _X_m_M_E_N_U__P_O_P_U_P. The values are: _X_m_T_E_A_R__O_F_F__E_N_A_B_L_E_D or _X_m_T_E_A_R__O_F_F__D_I_S_A_B_L_E_D (default value). This resource is invalid for type _X_m_M_E_N_U__O_P_T_I_O_N; however, it does affect any pulldown submenus within an OptionMenu. The function _X_m_R_e_p_T_y_p_e_I_n_s_t_a_l_l_T_e_a_r_O_f_f_M_o_d_e_l_C_o_n_v_e_r_t_e_r installs a resource converter for this resource. _X_m_N_u_n_m_a_p_C_a_l_l_b_a_c_k Specifies a list of callbacks that is called after the window associated with the RowColumn widget has been unmapped. The callback reason is _X_m_C_R__U_N_M_A_P. The default value is NULL. _X_m_N_w_h_i_c_h_B_u_t_t_o_n Page 13 (printed 11/11/03) XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) This resource is obsolete; it has been replaced by _X_m_N_m_e_n_u_P_o_s_t and is present for compatibility with older releases of 1/Motif. XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn CCCCoooonnnnssssttttrrrraaaaiiiinnnntttt RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt NNNNaaaammmmeeee CCCCllllaaaassssssss TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss ______________________________________________________________________ XmNpositionIndex XmCPositionIndex short XmLAST_POSITION CSG _X_m_N_p_o_s_i_t_i_o_n_I_n_d_e_x Specifies the position of the widget in its parent's list of children (the value of the _X_m_N_c_h_i_l_d_r_e_n resource). The value is an integer that is no less than zero and no greater than the number of children in the list at the time the value is specified. A value of zero means that the child is placed at the beginning of the list. The value can also be specified as _X_m_L_A_S_T__P_O_S_I_T_I_O_N (the default), which means that the child is placed at the end of the list. Any other value is ignored. _X_t_G_e_t_V_a_l_u_e_s returns the position of the widget in its parent's child list at the time of the call to _X_t_G_e_t_V_a_l_u_e_s. When a widget is inserted into its parent's child list, the positions of any existing children that are greater than or equal to the specified widget's _X_m_N_p_o_s_i_t_i_o_n_I_n_d_e_x are increased by one. The effect of a call to _X_t_S_e_t_V_a_l_u_e_s for _X_m_N_p_o_s_i_t_i_o_n_I_n_d_e_x is to remove the specified widget from its parent's child list, decrease by one the positions of any existing children that are greater than the specified widget's former position in the list, and then insert the specified widget into its parent's child list as described in the preceding sentence. SSSSiiiimmmmpppplllleeee MMMMeeeennnnuuuu CCCCrrrreeeeaaaattttiiiioooonnnn RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt NNNNaaaammmmeeee CCCCllllaaaassssssss TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss _______________________________________________________________________________________________ XmNbuttonAccelerators XmCButtonAccelerators StringTable NULL C XmNbuttonAcceleratorText XmCButtonAcceleratorText XmStringTable NULL C XmNbuttonCount XmCButtonCount int 0 C XmNbuttonMnemonicCharSets XmCButtonMnemonicCharSets XmStringCharSetTable NULL C XmNbuttonMnemonics XmCButtonMnemonics XmKeySymTable NULL C XmNbuttons XmCButtons XmStringTable NULL C XmNbuttonSet XmCButtonSet int -1 C XmNbuttonType XmCButtonType XmButtonTypeTable NULL C XmNoptionLabel XmCOptionLabel XmString NULL C Page 14 (printed 11/11/03) XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) XmNoptionMnemonic XmCOptionMnemonic KeySym NULL C XmNpostFromButton XmCPostFromButton int -1 C XmNsimpleCallback XmCCallback XtCallbackProc NULL C _X_m_N_b_u_t_t_o_n_A_c_c_e_l_e_r_a_t_o_r_s This resource is for use with the simple menu creation routines. It specifies a list of accelerators for the buttons created. The list contains one element for each button, separator, and title created. _X_m_N_b_u_t_t_o_n_A_c_c_e_l_e_r_a_t_o_r_T_e_x_t This resource is for use with the simple menu creation routines. It specifies a list of compound strings to display for the accelerators for the buttons created. The list contains one element for each button, separator, and title created. _X_m_N_b_u_t_t_o_n_C_o_u_n_t This resource is for use with the simple menu creation routines. It specifies the total number of menu buttons, separators, and titles to create. The value must not be negative. _X_m_N_b_u_t_t_o_n_M_n_e_m_o_n_i_c_C_h_a_r_S_e_t_s This resource is for use with the simple menu creation routines. It specifies a list of character sets with which button mnemonics are to be displayed. The list contains one element for each button, separator, and title created. The default is determined dynamically depending on the locale of the widget. _X_m_N_b_u_t_t_o_n_M_n_e_m_o_n_i_c_s This resource is for use with the simple menu creation routines. It specifies a list of mnemonics for the buttons created. The list contains one element for each button, separator, and title created. _X_m_N_b_u_t_t_o_n_s This resource is for use with the simple menu creation routines. It specifies a list of compound strings to use as labels for the buttons created. The list contains one element for each button, separator, and title created. _X_m_N_b_u_t_t_o_n_S_e_t This resource is for use with the simple menu creation routines. It specifies which button of a RadioBox or OptionMenu Pulldown submenu is initially set. The value is an integer nnnn indicating the nnnnth ToggleButtonGadget specified for a RadioBox or the nnnnth PushButtonGadget specified for an OptionMenu Pulldown Page 15 (printed 11/11/03) XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) submenu. The first button specified is number 0. The value must not be negative. _X_m_N_b_u_t_t_o_n_T_y_p_e This resource is for use with the simple menu creation routines. It specifies a list of button types associated with the buttons to be created. The list contains one element for each button, separator, and title created. If this resource is not specified, each button in a MenuBar is a CascadeButtonGadget, each button in a RadioBox or CheckBox is a ToggleButtonGadget, and each button in any other type of RowColumn widget is a PushButtonGadget. Each button type is of type _X_m_B_u_t_t_o_n_T_y_p_e, an enumeration with the following possible values: _X_m_C_A_S_C_A_D_E_B_U_T_T_O_N - Specifies a CascadeButtonGadget for a MenuBar, Popup MenuPane, or Pulldown MenuPane. _X_m_C_H_E_C_K_B_U_T_T_O_N - Specifies a ToggleButtonGadget for a CheckBox, Popup MenuPane, or Pulldown MenuPane. _X_m_D_O_U_B_L_E__S_E_P_A_R_A_T_O_R - Specifies a SeparatorGadget for a Popup MenuPane, Pulldown MenuPane, or OptionMenu Pulldown submenu. The separator type is _X_m_D_O_U_B_L_E__L_I_N_E. _X_m_P_U_S_H_B_U_T_T_O_N - Specifies a PushButtonGadget for a Popup MenuPane, Pulldown MenuPane, or OptionMenu Pulldown submenu. _X_m_R_A_D_I_O_B_U_T_T_O_N - Specifies a ToggleButtonGadget for a RadioBox, Popup MenuPane, or Pulldown MenuPane. _X_m_S_E_P_A_R_A_T_O_R - Specifies a SeparatorGadget for a Popup MenuPane, Pulldown MenuPane, or OptionMenu Pulldown submenu. _X_m_T_I_T_L_E - Specifies a LabelGadget used as a title for a Popup MenuPane or Pulldown MenuPane. _X_m_N_o_p_t_i_o_n_L_a_b_e_l This resource is for use with the simple menu creation routines. It specifies a compound string for the label string to be used on the left side of an OptionMenu. _X_m_N_o_p_t_i_o_n_M_n_e_m_o_n_i_c This resource is for use with the simple menu creation routines. It specifies a keysym for a key that, when pressed by the user along with the _M_A_l_t modifier, posts the associated Pulldown MenuPane for an OptionMenu. _X_m_N_p_o_s_t_F_r_o_m_B_u_t_t_o_n Page 16 (printed 11/11/03) XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) This resource is for use with the simple menu creation routines. For a Pulldown MenuPane, it specifies the button in the parent to which the submenu is attached. The menu is then posted from this button. The value is an integer nnnn indicating the nnnnth CascadeButton or CascadeButtonGadget specified for the parent of the Pulldown MenuPane. The first button specified is number 0. The value must not be negative. _X_m_N_s_i_m_p_l_e_C_a_l_l_b_a_c_k This resource is for use with the simple menu creation routines. It specifies a callback procedure to be called when a button is activated or when its value changes. This callback function is added to each button after creation. For a CascadeButtonGadget or a PushButtonGadget, the callback is added as the button's _X_m_N_a_c_t_i_v_a_t_e_C_a_l_l_b_a_c_k, and it is called when the button is activated. For a ToggleButtonGadget, the callback is added as the button's _X_m_N_v_a_l_u_e_C_h_a_n_g_e_d_C_a_l_l_b_a_c_k, and it is called when the button's value changes. The button number is passed in the cccclllliiiieeeennnntttt____ddddaaaattttaaaa field. IIIInnnnhhhheeeerrrriiiitttteeeedddd RRRReeeessssoooouuuurrrrcccceeeessss RowColumn inherits behavior and resources from the following named superclasses. For a complete description of each resource, refer to the man page for that superclass. XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt NNNNaaaammmmeeee CCCCllllaaaassssssss TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss _________________________________________________________________________________________________ XmNbottomShadowColor XmCBottomShadowColor Pixel dynamic CSG XmNbottomShadowPixmap XmCBottomShadowPixmap Pixmap XmUNSPECIFIED_PIXMAP CSG XmNforeground XmCForeground Pixel dynamic CSG XmNhelpCallback XmCCallback XtCallbackList NULL C XmNhighlightColor XmCHighlightColor Pixel dynamic CSG XmNhighlightPixmap XmCHighlightPixmap Pixmap dynamic CSG XmNinitialFocus XmCInitialFocus Widget NULL CSG XmNnavigationType XmCNavigationType XmNavigationType dynamic CSG XmNshadowThickness XmCShadowThickness Dimension dynamic CSG XmNstringDirection XmCStringDirection XmStringDirection dynamic CG XmNtopShadowColor XmCTopShadowColor Pixel dynamic CSG XmNtopShadowPixmap XmCTopShadowPixmap Pixmap dynamic CSG XmNtraversalOn XmCTraversalOn Boolean dynamic CSG XmNunitType XmCUnitType unsigned char dynamic CSG XmNuserData XmCUserData XtPointer NULL CSG CCCCoooommmmppppoooossssiiiitttteeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt NNNNaaaammmmeeee CCCCllllaaaassssssss TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss ________________________________________________________________________________ Page 17 (printed 11/11/03) XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) XmNchildren XmCReadOnly WidgetList NULL G XmNinsertPosition XmCInsertPosition XtOrderProc default procedure CSG XmNnumChildren XmCReadOnly Cardinal 0 G CCCCoooorrrreeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt NNNNaaaammmmeeee CCCCllllaaaassssssss TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss ______________________________________________________________________________________________________________ XmNaccelerators XmCAccelerators XtAccelerators dynamic CSG XmNancestorSensitive XmCSensitive Boolean dynamic G XmNbackground XmCBackground Pixel dynamic CSG XmNbackgroundPixmap XmCPixmap Pixmap XmUNSPECIFIED_PIXMAP CSG XmNborderColor XmCBorderColor Pixel XtDefaultForeground CSG XmNborderPixmap XmCPixmap Pixmap XmUNSPECIFIED_PIXMAP CSG XmNborderWidth XmCBorderWidth Dimension 0 CSG XmNcolormap XmCColormap Colormap dynamic CG XmNdepth XmCDepth int dynamic CG XmNdestroyCallback XmCCallback XtCallbackList NULL C XmNheight XmCHeight Dimension dynamic CSG XmNinitialResourcesPersistent XmCInitialResourcesPersistent Boolean True C XmNmappedWhenManaged XmCMappedWhenManaged Boolean True CSG XmNscreen XmCScreen Screen * dynamic CG XmNsensitive XmCSensitive Boolean True CSG XmNtranslations XmCTranslations XtTranslations dynamic CSG XmNwidth XmCWidth Dimension dynamic CSG XmNx XmCPosition Position 0 CSG XmNy XmCPosition Position 0 CSG CCCCaaaallllllllbbbbaaaacccckkkk IIIInnnnffffoooorrrrmmmmaaaattttiiiioooonnnn A pointer to the following structure is passed to each callback: typedef struct { int rrrreeeeaaaassssoooonnnn; _X_E_v_e_n_t **** eeeevvvveeeennnntttt; _W_i_d_g_e_t wwwwiiiiddddggggeeeetttt; _c_h_a_r **** ddddaaaattttaaaa; _c_h_a_r **** ccccaaaallllllllbbbbaaaacccckkkkssssttttrrrruuuucccctttt; } _X_m_R_o_w_C_o_l_u_m_n_C_a_l_l_b_a_c_k_S_t_r_u_c_t; rrrreeeeaaaassssoooonnnn Indicates why the callback was invoked eeeevvvveeeennnntttt Points to the _X_E_v_e_n_t that triggered the callback The following fields apply only when the callback reason is _X_m_C_R__A_C_T_I_V_A_T_E; for all other callback reasons, these fields are set to NULL. The _X_m_C_R__A_C_T_I_V_A_T_E callback reason is generated only when the application has supplied an entry callback, which Page 18 (printed 11/11/03) XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) overrides any activation callbacks registered with the individual RowColumn items. wwwwiiiiddddggggeeeetttt Is set to the widget ID of the RowColumn item that has been activated ddddaaaattttaaaa Contains the client-data value supplied by the application when the RowColumn item's activation callback was registered ccccaaaallllllllbbbbaaaacccckkkkssssttttrrrruuuucccctttt Points to the callback structure generated by the RowColumn item's activation callback TTTTrrrraaaannnnssssllllaaaattttiiiioooonnnnssss XmRowColumn translations depend on the value of the _X_m_N_r_o_w_C_o_l_u_m_n_T_y_p_e resource. If _X_m_N_r_o_w_C_o_l_u_m_n_T_y_p_e is set to _X_m_W_O_R_K__A_R_E_A, XmRowColumn inherits translations from XmManager. If _X_m_N_r_o_w_C_o_l_u_m_n_T_y_p_e is set to _X_m_M_E_N_U__O_P_T_I_O_N, XmRowColumn inherits traversal, KActivate, and KCancel translations from XmManager and has the additional translations listed below. These translations may not directly correspond to a translation table. BSelect Press: MenuBtnDown() BSelect Release:MenuBtnUp() KSelect: ManagerGadgetSelect() KHelp: Help() The translations for XmRowColumn if _X_m_N_r_o_w_C_o_l_u_m_n_T_y_p_e is set to _X_m_M_E_N_U__B_A_R _X_m_M_E_N_U__P_U_L_L_D_O_W_N, or _X_m_M_E_N_U__P_O_P_U_P are listed below. In a Popup menu system, _B_M_e_n_u also performs the _B_S_e_l_e_c_t actions. When the value of the XmDisplay resource _e_n_a_b_l_e_M_e_n_u_I_n_C_a_s_c_a_d_e is True, _B_M_e_n_u also performs the _B_S_e_l_e_c_t actions in all types of menu systems. These translations may not directly correspond to a translation table. BSelect Press: MenuBtnDown() BSelect Release:MenuBtnUp() KActivate: ManagerGadgetSelect() KSelect: ManagerGadgetSelect() MAny KCancel: MenuGadgetEscape() KHelp: Help() KLeft: MenuGadgetTraverseLeft() KRight: MenuGadgetTraverseRight() KUp: MenuGadgetTraverseUp() KDown: MenuGadgetTraverseDown() AAAAccccttttiiiioooonnnn RRRRoooouuuuttttiiiinnnneeeessss The XmRowColumn action routines are described below: Page 19 (printed 11/11/03) XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) _H_e_l_p(): Calls the callbacks for _X_m_N_h_e_l_p_C_a_l_l_b_a_c_k if any exist. If there are no help callbacks for this widget, this action calls the help callbacks for the nearest ancestor that has them. _M_a_n_a_g_e_r_G_a_d_g_e_t_S_e_l_e_c_t(): When a gadget child of the menu has the focus, invokes the gadget child's behavior associated with _K_S_e_l_e_c_t. This generally has the effect of unposting the menu hierarchy and arming and activating the gadget, except that for a CascadeButtonGadget with a submenu, it posts the submenu. _M_e_n_u_B_t_n_D_o_w_n(): When a gadget child of the menu has the focus, invokes the gadget child's behavior associated with _B_S_e_l_e_c_t _P_r_e_s_s. This generally has the effect of unposting any menus posted by the parent menu, enabling mouse traversal in the menu, and arming the gadget. For a CascadeButtonGadget with a submenu, it also posts the associated submenu. _M_e_n_u_B_t_n_U_p(): When a gadget child of the menu has the focus, invokes the gadget child's behavior associated with _B_S_e_l_e_c_t _R_e_l_e_a_s_e. This generally has the effect of unposting the menu hierarchy and activating the gadget, except that for a CascadeButtonGadget with a submenu, it posts the submenu and enables keyboard traversal in the menu. _M_e_n_u_G_a_d_g_e_t_E_s_c_a_p_e(): In a toplevel Pulldown MenuPane from a MenuBar, unposts the menu, disarms the MenuBar CascadeButton and the MenuBar, and, when the shell's keyboard focus policy is _X_m_E_X_P_L_I_C_I_T, restores keyboard focus to the widget that had the focus before the MenuBar was entered. In other Pulldown MenuPanes, unposts the menu. In a Popup MenuPane, unposts the menu and, when the shell's keyboard focus policy is _X_m_E_X_P_L_I_C_I_T, restores keyboard focus to the widget from which the menu was posted. In a TearOff MenuPane that has no submenus posted, dismisses the menu; otherwise, if one or more submenus are posted, unposts the last menu pane. _M_e_n_u_G_a_d_g_e_t_T_r_a_v_e_r_s_e_D_o_w_n(): If the current menu item has a submenu and is in a MenuBar, then this action posts the submenu, disarms the current menu item, and arms the submenu's first traversable menu item. Page 20 (printed 11/11/03) XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) If the current menu item is in a MenuPane, then this action disarms the current menu item and arms the item below it. This action wraps within the MenuPane. When the current menu item is at the MenuPane's bottom edge, then this action wraps to the topmost menu item in the column to the right, if one exists. When the current menu item is at the bottom, rightmost corner of the MenuPane, then this action wraps to the tear-off control, if present, or to the top, leftmost menu item. _M_e_n_u_G_a_d_g_e_t_T_r_a_v_e_r_s_e_L_e_f_t(): When the current menu item is in a MenuBar, then this action disarms the current item and arms the MenuBar item to the left. This action wraps within the MenuBar. In MenuPanes, if the current menu item is not at the left edge of a MenuPane, this action disarms the current item and arms the item to its left. If the current menu item is at the left edge of a submenu attached to a MenuBar item, then this action unposts the submenu and traverses to the MenuBar item to the left, wrapping if necessary. If that MenuBar item has a submenu, it posts the submenu and arms the first traversable item in the submenu. If the current menu item is at the left edge of a submenu not directly attached to a MenuBar item, then this action unposts the current submenu only. In Popup or Torn-off MenuPanes, when the current menu item is at the left edge, this action wraps within the MenuPane. If the current menu item is at the left edge of the MenuPane and not in the top row, this action wraps to the rightmost menu item in the row above. If the current menu item is in the upper, leftmost corner, this action wraps to the tear-off control, if present, or else it wraps to the bottom, rightmost menu item in the MenuPane. _M_e_n_u_G_a_d_g_e_t_T_r_a_v_e_r_s_e_R_i_g_h_t(): If the current menu item is in a MenuBar, then this action disarms the current item and arms the MenuBar item to the right. This action wraps within the MenuBar. In MenuPanes, if the current menu item is a CascadeButton, then this action posts its associated submenu. If the current menu item is not a CascadeButton and is not at the right edge of a MenuPane, this action disarms the current item and arms the item to its right, wrapping if necessary. If the current menu item is not a CascadeButton and is at the Page 21 (printed 11/11/03) XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) right edge of a submenu that is a descendent of a MenuBar, then this action unposts all submenus and traverses to the MenuBar item to the right. If that MenuBar item has a submenu, it posts the submenu and arms the submenu's first traversable item. In Popup or Torn-off menus, if the current menu item is not a CascadeButton and is at the right edge of a row (except the bottom row), this action wraps to the leftmost menu item in the row below. If the current menu item is not a CascadeButton and is in the bottom, rightmost corner of a Popup or Pulldown MenuPane, this action wraps to the tear-off control, if present, or else it wraps to the top, leftmost menu item of the MenuPane. _M_e_n_u_G_a_d_g_e_t_T_r_a_v_e_r_s_e_U_p(): When the current menu item is in a MenuPane, then this action disarms the current menu item and arms the item above it. This action wraps within the MenuPane. When the current menu item is at the MenuPane's top edge, then this action wraps to the bottommost menu item in the column to the left, if one exists. When the current menu item is at the top, leftmost corner of the MenuPane, then this action wraps to the tear-off control, if present, or to the bottom, rightmost menu item. RRRReeeellllaaaatttteeeedddd BBBBeeeehhhhaaaavvvviiiioooorrrr The following menu functions are available. _K_M_e_n_u_B_a_r: In any non-popup descendant of a MenuBar's parent, excluding the MenuBar itself, this action enables keyboard traversal and moves keyboard focus to the first item in the MenuBar. In the MenuBar or any menu cascaded from it, this action unposts the menu hierarchy and, when the shell's keyboard focus policy is _X_m_E_X_P_L_I_C_I_T, restores focus to the widget that had the focus when the menu system was entered. _K_M_e_n_u: Pops up the menu associated with the control that has the keyboard focus. Enables keyboard traversal in the menu. In the Popup menu system or any menu cascaded from it, this action unposts the menu hierarchy and, when the shell's keyboard focus policy is _X_m_E_X_P_L_I_C_I_T, restores focus to the widget that had the focus when the menu system was entered. VVVViiiirrrrttttuuuuaaaallll BBBBiiiinnnnddddiiiinnnnggggssss The bindings for virtual keys are vendor specific. For Page 22 (printed 11/11/03) XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) information about bindings for virtual buttons and keys, see _V_i_r_t_u_a_l_B_i_n_d_i_n_g_s(_3_X). RRRREEEELLLLAAAATTTTEEEEDDDD IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN _C_o_m_p_o_s_i_t_e(_3_X), _C_o_n_s_t_r_a_i_n_t(_3_X), _C_o_r_e(_3_X), _X_m_C_r_e_a_t_e_M_e_n_u_B_a_r(_3_X), _X_m_C_r_e_a_t_e_O_p_t_i_o_n_M_e_n_u(_3_X), _X_m_C_r_e_a_t_e_P_o_p_u_p_M_e_n_u(_3_X), _X_m_C_r_e_a_t_e_P_u_l_l_d_o_w_n_M_e_n_u(_3_X), _X_m_C_r_e_a_t_e_R_a_d_i_o_B_o_x(_3_X), _X_m_C_r_e_a_t_e_R_o_w_C_o_l_u_m_n(_3_X), _X_m_C_r_e_a_t_e_S_i_m_p_l_e_C_h_e_c_k_B_o_x(_3_X), _X_m_C_r_e_a_t_e_S_i_m_p_l_e_M_e_n_u_B_a_r(_3_X), _X_m_C_r_e_a_t_e_S_i_m_p_l_e_O_p_t_i_o_n_M_e_n_u(_3_X), _X_m_C_r_e_a_t_e_S_i_m_p_l_e_P_o_p_u_p_M_e_n_u(_3_X), _X_m_C_r_e_a_t_e_S_i_m_p_l_e_P_u_l_l_d_o_w_n_M_e_n_u(_3_X), _X_m_C_r_e_a_t_e_S_i_m_p_l_e_R_a_d_i_o_B_o_x(_3_X), _X_m_C_r_e_a_t_e_W_o_r_k_A_r_e_a(_3_X), _X_m_D_i_s_p_l_a_y(_3_X), _X_m_G_e_t_M_e_n_u_C_u_r_s_o_r(_3_X), _X_m_G_e_t_P_o_s_t_e_d_F_r_o_m_W_i_d_g_e_t(_3_X), _X_m_G_e_t_T_e_a_r_O_f_f_C_o_n_t_r_o_l, _X_m_L_a_b_e_l(_3_X), _X_m_M_a_n_a_g_e_r(_3_X), _X_m_M_e_n_u_P_o_s_i_t_i_o_n(_3_X), _X_m_O_p_t_i_o_n_B_u_t_t_o_n_G_a_d_g_e_t(_3_X), _X_m_O_p_t_i_o_n_L_a_b_e_l_G_a_d_g_e_t(_3_X), _X_m_R_e_p_T_y_p_e_I_n_s_t_a_l_l_T_e_a_r_O_f_f_M_o_d_e_l_C_o_n_v_e_r_t_e_r, _X_m_S_e_t_M_e_n_u_C_u_r_s_o_r(_3_X), _X_m_U_p_d_a_t_e_D_i_s_p_l_a_y(_3_X), _X_m_V_a_C_r_e_a_t_e_S_i_m_p_l_e_C_h_e_c_k_B_o_x(_3_X), _X_m_V_a_C_r_e_a_t_e_S_i_m_p_l_e_M_e_n_u_B_a_r(_3_X), _X_m_V_a_C_r_e_a_t_e_S_i_m_p_l_e_O_p_t_i_o_n_M_e_n_u(_3_X), _X_m_V_a_C_r_e_a_t_e_S_i_m_p_l_e_P_o_p_u_p_M_e_n_u(_3_X), _X_m_V_a_C_r_e_a_t_e_S_i_m_p_l_e_P_u_l_l_d_o_w_n_M_e_n_u(_3_X), and _X_m_V_a_C_r_e_a_t_e_S_i_m_p_l_e_R_a_d_i_o_B_o_x(_3_X). Page 23 (printed 11/11/03)